home *** CD-ROM | disk | FTP | other *** search
- TABLE OF CONTENTS
-
- imageprocess.library/--background--
- imageprocess.library/--history--
- imageprocess.library/DoImageProcessA
- imageprocess.library/IMP_AutoGamma
- imageprocess.library/IMP_Negative
- imageprocess.library/IMP_Scale
- imageprocess.library/IMP_SwapColourSpace
- imageprocess.library/--background-- imageprocess.library/--background--
-
- PURPOSE
- To allow the processing of image buffers.
-
- COPYRIGHT
- The copyright in this library is owned by Paul Huxham.
-
- DISCLAIMER
- imageprocess.library and its associated files are supposed to enable the
- processing of image buffers. Even though every effort has been made to
- make imageprocess.library as stable and functional as possible, I
- cannot rule out the possibility that imageprocess.library may have bugs
- that have side effects (possibly harmful) on your system.
-
- I hereby reject any liability or responsibility for these or any other
- consequences from the use of imageprocess.library whatsoever. This
- includes, but is not limited to, damage to your equipment, to your data,
- personal injuries, financial loss or any other kinds of side effects.
-
- imageprocess.library is provided as-is. This means I do not guarantee that
- imageprocess.library is fit for any specific purpose and I do not guarantee
- any bug fixes, updates or help during error recovery.
-
- DISTRIBUTION
- imageprocess.library should be distributed at no charge to the end user.
- It may be included on Aminet CDs.
-
- The author retains all rights to the enclosed software. Payment is not
- required for the use of imageprocess.library in public domain software.
-
- For ANY COMMERCIAL APPLICATION using imageprocess.library, contact the
- author for further information concerning distribution.
-
- REQUIREMENTS
- A minimum of Kickstart 3.0, 68020 CPU is required to use
- imageprocess.library.
-
- COMPLIER
- imageproces.library was written and compiled using CED V3.5, SAS/C 6.58 and
- vbcc on an Amiga 4000/060. CyberGuard was used to detect/correct
- programming errors.
-
- BUGS
- Should you find any bugs, please report them so that they can be fixed.
- Likewise any suggestions for improvment of the library should be
- forwarded so that they can be addressed.
-
- THANKYOUS
- Many thanks to
- Dinh Thi Kim Tuyen
- - Who makes the sky blue and the world turn. I love you, forevermore.
-
- Steve Quartly
- - For pushing me into corners I wouldn't normally go, to teach me to
- see things where I would normally give up.
-
- AUTHOR
- You can contact the author via:
- email: paulhuxham@yahoo.com
- www: http://mafeking.scouts.org.au/steeplesoftware
-
- imageprocess.library/--history-- imageprocess.library/--history--
-
- V1.0
- > Initial release.
-
- imageprocess.library/DoImageProcessA imageprocess.library/DoImageProcessA
-
- NAME
- DoImageProcessA -- Process image data in memory
- DoImageProcess -- Varargs stub
-
- SYNOPSIS
- err = DoImageProcessA( process, taglist )
- d0 a0
-
- err = DoImageProcessA( ULONG process, struct TagItem *taglist )
-
- err = DoImageProcess( process, tag1, ... )
-
- err = DoImageProcess( ULONG process, ULONG tag1, ... )
-
- FUNCTION
- Perform an operation on a buffer in memory.
-
- Image process operations available in V1.0:
- IMP_AutoGamma
- IMP_Negative
- IMP_Scale
- IMP_SwapColourSpace
-
- Available tags:
- IMP_SourceImageIOHandle - Pointer to an already allocated and loaded
- imageio.library buffer. Processes can be
- performed either inline on the imageio handle
- or they can produce a new buffer
- (struct ImageHandle *).
- IMP_SourceBuffer - Pointer to a buffer in memory (UBYTE *).
- IMP_SourceWidth - Width of IMP_SourceBuffer.
- IMP_SourceHeight - Height of IMP_SourceBuffer.
- IMP_SourceColourSpace - Colourspace of IMP_SourceBuffer.
- IMP_SourceBytesPerPixel - Bytes per pixel of IMP_SourceBuffer.
- IMP_MemoryPool - Allocate memory on this pool (this tag is NOT
- permitted with an imagiohandle source buffer)
- (void *).
- IMP_ProcessInline - Request the process to be done inline (if
- possible - not all methods support this eg
- scaling and swapcolourspace) (BOOL).
-
- Result tags:
- IMP_Buffer - Buffer (UBYTE **).
- IMP_BufferSize - Size of memory allocated in bytes (ULONG *).
- IMP_Width - Buffer width in pixels (ULONG *).
- IMP_Height - Buffer height in pixels (ULONG *).
- IMP_BytesPerPixel - Bytes per buffer pixel (LUONG *).
- IMP_ColourSpace - Type of buffer data (ULONG *).
-
- INPUTS
- process - image process perform (defined above).
- taglist - pointer to a tag list.
-
- RESULT
- err - if non NULL contains an error code. (For a complete list of error
- codes, see imageprocess.h)
-
- WARNING
- If you are not processing inline, YOU are responsible for FreeMem()ing the
- memory allocated by using the tags IMP_Buffer and IMP_BufferSize to obtain
- the size and location of memory allocated for the new buffer.
-
- BUGS
-
- SEE ALSO
-
- imageprocess.library/IMP_AutoGamma imageprocess.library/IMP_AutoGamma
-
- NAME
- IMP_AutoGamma
-
- SYNOPSIS
-
- FUNCTION
- Autocorrect the gamma of a buffer.
-
- Available tags:
- IMP_GammaMode - Either GAMMA_BEST (strict gamma correction - slower) or
- GAMMA_FAST (not strictly correct, but faster). Defaults
- to GAMMA_FAST.
- INPUTS
-
- RESULT
-
- NOTES
- Supports rgb and greyscale buffers.
-
- WARNING
-
- BUGS
-
- SEE ALSO
-
- imageprocess.library/IMP_Negative imageprocess.library/IMP_Negative
-
- NAME
- IMP_Negtive
-
- SYNOPSIS
-
- FUNCTION
- Generate a negative of the buffer.
-
- INPUTS
-
- RESULT
-
- NOTES
- Supports rgb and greyscale buffers.
-
- WARNING
-
- BUGS
-
- SEE ALSO
-
- imageprocess.library/IMP_Scale imageprocess.library/IMP_Scale
-
- NAME
- IMP_Scale
-
- SYNOPSIS
-
- FUNCTION
- Scale a buffer to a new size.
-
- Available tags:
- IMP_ScaleNum - Numerator for scaling. Defaults to 1 (ULONG).
- IMP_ScaleDenom - Denomenator for scaling. Defaults to 1 (ULONG).
- IMP_ScaledWidth - Required width of scaled buffer in pixels
- (ULONG).
- IMP_ScaledHeight - Required height of scaled buffer in pixels
- (ULONG).
- IMP_ScaleMaintainAspect - Maintain aspect ratio when scaling (BOOL).
- IMP_ScaleType - The scaling mode (ULONG).
- IPSCALE_FAST - Fast below average quality.
- IPSCALE_NORMAL - Good quality, medium speed (default).
- IPSCALE_BEST - Best quality, slow.
-
- INPUTS
-
- RESULT
-
- NOTES
- Supports rgb and greyscale buffers.
-
- WARNING
- Scaling is only supported inline for imageio handles.
-
- BUGS
-
- SEE ALSO
-
- imageprocess.library/IMP_SwapColourSpacegeprocess.library/IMP_SwapColourSpace
-
- NAME
- IMP_SwapColourSpace
-
- SYNOPSIS
-
- FUNCTION
- Change the colour space of a buffer.
-
- Available tags:
- IMP_NewColourSpace - A new colour space, defined in
- imageio/imagegeneric.h. Not all colourspaces are
- supported.
- INPUTS
-
- RESULT
-
- NOTES
- Supports rgb, argb and greyscale buffers.
-
- WARNING
- Swapcolourspace is only supported inline for imageio handles.
-
- BUGS
-
- SEE ALSO
-
-